package com.ruoyi.common.core.service;

import java.io.Serializable;
import java.util.List;
import java.util.Map;

/**
 * 基础 Service 接口（纯 MyBatis 实现）
 * @param <T> 实体类类型
 */
public interface BaseService<T> {

    /**
     * 新增实体
     * @param entity 实体对象
     * @return 影响行数
     */
    int save(T entity);

    /**
     * 批量新增
     * @param entityList 实体列表
     * @return 影响行数
     */
    int saveBatch(List<T> entityList);

    /**
     * 根据 ID 更新实体（全字段更新）
     * @param entity 实体对象（含 ID）
     * @return 影响行数
     */
    int updateById(T entity);

    /**
     * 根据 ID 选择性更新（非空字段才更新）
     * @param entity 实体对象（含 ID）
     * @return 影响行数
     */
    int updateSelectiveById(T entity);

    /**
     * 根据 ID 删除
     * @param id 主键 ID
     * @return 影响行数
     */
    int removeById(Long id);

    /**
     * 批量删除
     * @param ids 主键 ID 列表（逗号分隔，如 "1,2,3"）
     * @return 影响行数
     */
    int removeByIds(String ids);

    /**
     * 根据 ID 查询
     * @param id 主键 ID
     * @return 实体对象
     */
    T getById(Long id);

    /**
     * 查询所有
     * @return 实体列表
     */
    List<T> listAll();

    /**
     * 条件查询（实体非空字段作为条件）
     * @param entity 实体条件
     * @return 实体列表
     */
    List<T> listByEntity(T entity);

    /**
     * 条件查询（Map 参数作为条件）
     * @param params 条件参数
     * @return 实体列表
     */
    List<T> listByMap(Map<String, Object> params);

    /**
     * 分页查询（需配合 MyBatis 分页插件）
     * @param pageNum 页码（从 1 开始）
     * @param pageSize 每页条数
     * @param entity 条件实体（可选）
     * @return 分页结果（含总条数、列表数据）
     */
    Map<String, Object> pageList(int pageNum, int pageSize, T entity);
}